#ifndef __DATETIMEUTILS__H__
#define __DATETIMEUTILS__H__

#include <stdbool.h>
#include <stdio.h>
#include <memory.h>
#include <time.h>

/**
 * 格式 FORMAT 控制着输出格式. 仅当选项指定为全球时间时本格式才有效。 分别解释如下:
 * %%     文本的 %
 * %a     当前区域的星期几的简写 (Sun..Sat)
 * %A     当前区域的星期几的全称 (不同长度) (Sunday..Saturday)
 * %b     当前区域的月份的简写 (Jan..Dec)
 * %B     当前区域的月份的全称(变长) (January..December)
 * %c     当前区域的日期和时间 (Sat Nov 04 12:02:33 EST 1989)
 * %d     (月份中的)几号(用两位表示) (01..31)
 * %D     日期(按照 月/日期/年 格式显示) (mm/dd/yy)
 * %e     (月份中的)几号(去零表示) ( 1..31)
 * %h     同 %b
 * %H     小时(按 24 小时制显示，用两位表示) (00..23)
 * %I     小时(按 12 小时制显示，用两位表示) (01..12)
 * %j     (一年中的)第几天(用三位表示) (001..366)
 * %k     小时(按 24 小时制显示，去零显示) ( 0..23)
 * %l     小时(按 12 小时制显示，去零表示) ( 1..12)
 * %m     月份(用两位表示) (01..12)
 * %M     分钟数(用两位表示) (00..59)
 * %n     换行
 * %p     当前时间是上午 AM 还是下午 PM
 * %r     时间,按 12 小时制显示 (hh:mm:ss [A/P]M)
 * %s     从 1970年1月1日0点0分0秒到现在历经的秒数 (GNU扩充)
 * %S     秒数(用两位表示)(00..60)
 * %t     水平方向的 tab 制表符
 * %T     时间,按 24 小时制显示(hh:mm:ss)
 * %U     (一年中的)第几个星期，以星期天作为一周的开始(用两位表示) (00..53)
 * %V     (一年中的)第几个星期，以星期一作为一周的开始(用两位表示) (01..52)
 * %w     用数字表示星期几 (0..6); 0 代表星期天
 * %W     (一年中的)第几个星期，以星期一作为一周的开始(用两位表示) (00..53)
 * %x     按照 (mm/dd/yy) 格式显示当前日期
 * %X     按照 (%H:%M:%S) 格式显示当前时间
 * %y     年的后两位数字 (00..99)
 * %Y     年(用 4 位表示) (1970...)
 * %z     按照 RFC-822 中指定的数字时区显示(如, -0500) (为非标准扩充)
 * %Z     时区(例如, EDT (美国东部时区)), 如果不能决定是哪个时区则为空
 * 默认情况下,用 0 填充数据的空缺部分.  GNU 的 date 命令能分辨在 `%'和数字指示之间的以下修改.
 *         `-' (连接号) 不进行填充 `_' (下划线) 用空格进行填充
 */


typedef struct DateTime DateTime;
struct DateTime {
    time_t timestamp;       // 时间戳属性
    struct tm timestruct;   // 可变化的时间结构
};

// 初始化 DateTime 结构体为某种时间
struct tm* makeDateTime(DateTime *datetime, time_t timestamp, bool useLocalTime);

/**
 * The <time.h> header shall declare the tm structure, which shall include at least the following members:
 * 
 *     int    tm_sec   Seconds [0,60].
 *     int    tm_min   Minutes [0,59].
 *     int    tm_hour  Hour [0,23].
 *     int    tm_mday  Day of month [1,31].
 *     int    tm_mon   Month of year [0,11].
 *     int    tm_year  Years since 1900.
 *     int    tm_wday  Day of week [0,6] (Sunday =0).
 *     int    tm_yday  Day of year [0,365].
 *     int    tm_isdst Daylight Savings flag.
 */

// 时间戳
// 日历时间: 由协调世界时(UTC)时间计算历来的秒数
// 日历时间: 1970年1月1日 00:00:00 开始到现在的秒数
time_t currentCalendarTime();

// GMT(Greenwich Mean Time)格林尼治标准时 - 共享时间结构
struct tm* currentGreenwichMeanDateTime();

// UTC(Coordinated Universal Time)协调世界时，
// 由于目前无法提供闰秒功能，与格林尼治标准时实现相同 - 共享时间结构
struct tm* currentCoordinatedUniversalDateTime();
// ---------------------------------------------------------------- 

// 获取日历时间信息
struct tm* createCalendarDateTime(DateTime *datetime);
/*获取当前年份，从1900开始计算*/
int currentCalendarDateTimeYear(DateTime *datetime);
/*获取当前月份，范围是0-11*/
int currentCalendarDateTimeYearMonth(DateTime *datetime);
/*获取当前月分日数，范围是1-31*/
int currentCalendarDateTimeYearMonthDay(DateTime *datetime);
/*获取当前时，这里获取西方的时间，刚好相差八小时*/
int currentCalendarDateTimeYearMonthDayHour(DateTime *datetime);
/*获取当前分*/
int currentCalendarDateTimeYearMonthDayMinute(DateTime *datetime);
/*获取当前秒*/
int currentCalendarDateTimeYearMonthDaySecond(DateTime *datetime);

// 获取本地时间信息
// Local Time 本地时间 - 经由 '日历时间' 计算，时区自动调整(+8)
struct tm* createLocalDateTime(DateTime *datetime);
/*获取当前年份*/
int currentLocalDateTimeYear(DateTime *datetime);
/*获取当前月份，范围是1-12*/
int currentLocalDateTimeYearMonth(DateTime *datetime);
/*获取当前月分日数，范围是1-31*/
int currentLocalDateTimeYearMonthDay(DateTime *datetime);
/*获取当前时，这里获取西方的时间，刚好相差八小时*/
int currentLocalDateTimeYearMonthDayHour(DateTime *datetime);
/*获取当前分*/
int currentLocalDateTimeYearMonthDayMinute(DateTime *datetime);
/*获取当前秒*/
int currentLocalDateTimeYearMonthDaySecond(DateTime *datetime);


#endif  //!__DATETIMEUTILS__H__